Use case: encryption/decryption in polling mode

Sequence diagram

Encryption/decryption in polling mode

@startuml participant "Application" as App participant "CRYP" as CRYP note over App,CRYP: Encryption App -> CRYP: HAL_CRYP_Encrypt() group opt note over App,CRYP: Tag generation App -> CRYP: HAL_CRYPEx_AESGCM_GenerateAuthTAG() note right: **Only for GCM algorithm** App -> CRYP: HAL_CRYPEx_AESCCM_GenerateAuthTAG() note right: **Only for CCM algorithm** end group note over App,CRYP: Decryption App -> CRYP: HAL_CRYP_Decrypt() group opt note over App,CRYP: Tag generation App -> CRYP: HAL_CRYPEx_AESGCM_GenerateAuthTAG() note right: **Only for GCM algorithm** App -> CRYP: HAL_CRYPEx_AESCCM_GenerateAuthTAG() note right: **Only for CCM algorithm** end group @enduml

Code snippet

HAL1

HAL2 

/* Encryption */
HAL_CRYP_Encrypt(&hcryp, Plaintext, PLAINTEXT_SIZE,
                 EncryptedText, TIMEOUT_VALUE);

/* Only for GCM algorithm */
HAL_CRYPEx_AESGCM_GenerateAuthTAG(&hcryp,TAG,
                                TIMEOUT_VALUE);

/* Only for CCM algorithm */
HAL_CRYPEx_AESCCM_GenerateAuthTAG(&hcryp,TAG,
                                TIMEOUT_VALUE);

/* Decryption */
HAL_CRYP_Decrypt(&hcryp,Ciphertext , PLAINTEXT_SIZE,
                 DecryptedText, TIMEOUT_VALUE);

/* Only for GCM algorithm */
HAL_CRYPEx_AESGCM_GenerateAuthTAG(&hcryp,TAG,
                                TIMEOUT_VALUE);

/* Only for CCM algorithm */
HAL_CRYPEx_AESCCM_GenerateAuthTAG(&hcryp,TAG,
                                TIMEOUT_VALUE);

/* Encryption */
HAL_AES_Encrypt(&haes, Plaintext, PLAINTEXT_SIZE ,
               EncryptedText, TIMEOUT_VALUE);

/* Only for GCM algorithm */
HAL_AES_GCM_GenerateAuthTAG(&haes,TAG,
                             TIMEOUT_VALUE);

/* Only for CCM algorithm */
HAL_AES_CCM_GenerateAuthTAG(&haes,TAG,
                             TIMEOUT_VALUE);

/* Decryption */
HAL_AES_Decrypt(&haes, Ciphertext, PLAINTEXT_SIZE ,
                DecryptedText, TIMEOUT_VALUE);

/* Only for GCM algorithm */
HAL_AES_GCM_GenerateAuthTAG(&haes,TAG,
                              TIMEOUT_VALUE);

/* Only for CCM algorithm */
HAL_AES_CCM_GenerateAuthTAG(&haes,TAG,
                             TIMEOUT_VALUE);

Key changes

  1. Encryption and decryption APIs are renamed from HAL_CRYP_* to HAL_AES_*.

  2. Authentication tag generation APIs are renamed from HAL_CRYPEx_AES* to HAL_AES_* for GCM and CCM algorithms.